home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / ltmf130e.lzh / ltmf130e / LETEMFLY.TXT < prev   
Text File  |  1995-07-15  |  34KB  |  738 lines
  1.                              Let 'em Fly!
  2.                              ------------
  3.  
  4.                      (Flying Dials and more ...)
  5.  
  6.                              Version 1.30
  7.  
  8.                             15th July 1995
  9.  
  10.                      (c) 1991-93 by Oliver Scheel
  11.                         Freaky Deaky Software
  12.  
  13.                      (c) 1994-95 by Darryl Piper
  14.  
  15.                            (it's Freeware)
  16.  
  17.  
  18. 1 Introduction
  19. ==============
  20.  
  21. Well,  actually I only wanted to see how fast the Atari ST's VDI could 
  22. be, though it led on to rather more ...
  23.  
  24. With `Let 'em Fly!' in your AUTO-Folder, many normal GEM dialogs learn 
  25. to fly like Julian Reschke's FlyDials (e.g.  in `Gemini'),  or in  the 
  26. `Rufus' terminal program.  Furthermore these dialogs can be handled by 
  27. using the keyboard shortcuts `Let 'em Fly!' offers,  so that there  is 
  28. no  need to keep swapping between keyboard and mouse.  There are  many 
  29. more features! The most important:
  30.  
  31. - Flying dials
  32.     As already described,  many GEM dialogs learn to fly.  This  means 
  33.     you  can drag them around by using the mouse.  This requires  that 
  34.     programs  use the correct AES calls to handle dialogs.  The  alert 
  35.     boxes too can now fly.
  36.  
  37.     Thanks to clever procedures the boxes can be moved with  tolerable 
  38.     speed  even  without  a blitter,  and their  appearance  has  been 
  39.     optimised.  Furthermore  memory usage has been optimised  for  the 
  40.     whole  process,  i.e.  even when little memory is available it  is 
  41.     possible in some cases to move the boxes around.
  42.  
  43.     Furthermore `Let 'em Fly!' memorises the position of dialog  boxes 
  44.     inside a given program,  which means that after a box is moved  it 
  45.     will appear in the new position the next time it is called.
  46.  
  47.     Virtual screens such as `BigScreen 2.0' are also  supported,  with 
  48.     the  dialog  boxes  appearing centred  in  the  currently  visible 
  49.     portion of the screen.
  50.  
  51. - Key dials
  52.     Many dialogs can be operated by using keyboard shortcuts. `Let 'em 
  53.     Fly!' scans the dialog for suitable keys.  For example, the button 
  54.     `Cancel' may be activated by pressing [UNDO] and/or [ALT]+[C].
  55.  
  56. - New edit functions within editable fields
  57.     If  a  dialog  contains  editable  input  fields  then  additional 
  58.     editing  functions  become  available.   This  includes  Clipboard 
  59.     support, a `history' of the last 20 inputs and a special character 
  60.     box  to enter `ugly' characters.  Some of the edit  functions  can 
  61.     also  operate  in programs using their own routines  for  handling 
  62.     dialogs.
  63.  
  64. - New alert boxes with new icons
  65.     The  appearance of the alert boxes have also been  re-implemented. 
  66.     They are now only as large as they have to be, so look more `right 
  67.     sized'. They also allow the loading of new icons.
  68.  
  69. - Grow and shrink boxes can be switched off
  70.     To speed up screen re-draws,  `Let 'em Fly!' allows you to  switch 
  71.     off the grow and shrink boxes.
  72.  
  73. - No pilot's licence needed
  74.     You've  guessed it!  For using `Let 'em Fly!' you don't  need  any 
  75.     flying lessons.  But you should gave basic experience in using the 
  76.     mouse.
  77.  
  78.  
  79. `Let  'em Fly!' works on all Atari ST/STe/TT/Falcon computers  in  all 
  80. resolutions, including TruColor. MultiTOS is supported also.
  81.  
  82. `Let 'em Fly!' comes with no warranty. This means that the author will 
  83. not  be liable for any damage which may caused by using or  not  using 
  84. `Let 'em Fly!'.
  85.  
  86. `Let  'em  Fly!' is Freeware.  This means that this  programm  may  be 
  87. freely  used and distributed for non commercial use.  All  rights  are 
  88. reserved by the author!  Nearly all software and hardware titles  used 
  89. in  these instructions are registered trademarks and are to be  viewed 
  90. as such.
  91.  
  92.  
  93. The `Let 'em Fly!' distribution package (English version):
  94.  
  95.      - LETEMFLY.PRG           The program itself
  96.      - LET_CONF.CPX           The configuration CPX module
  97.  
  98.      - GEM1ICON.RSC           The original Atari icons for alert boxes
  99.      - GEM2ICON.RSC           Icons from GEM/2 for the alert boxes
  100.  
  101.      - LETEMFLY.TXT           This manual
  102.  
  103. `Let 'em Fly!' may only be distributed complete with these files.
  104.  
  105. I  do  not expect that everyone will understand  everything  in  these 
  106. instructions,  which is not really necessary for normal use.  This  is 
  107. due to the fact that the program digs deeply into the operating system 
  108. and to understand everything one has to know that inside out.
  109.  
  110.  
  111. 2 Installation
  112. ==============
  113.  
  114. It's very easy to install `Let 'em Fly!'. The LETEMFLY.PRG program can 
  115. be  run from the desktop or copied into your AUTO-folder on  the  boot 
  116. drive to load automatically when the computer is restarted.   You  can 
  117. install the CPX file into your CPX folder,  this  will  allow  you  to
  118. configure `Let 'em Fly!' as you wish.
  119.  
  120.  
  121. 3 Usage
  122. =======
  123.  
  124. Not all dialog boxes are supported by `Let 'em Fly!' since some people 
  125. have programmed their own dialog-handling routines.  In these `Let 'em 
  126. Fly!'  can do nothing,  or only make some of its  features  available. 
  127. `Let  'em  Fly!' requires that programs use the correct AES  calls  to 
  128. handle dialogs.
  129.  
  130. Nor  are  dialogs on the desktop supported,  since  TOS  accesses  its 
  131. routines directly here. That may change with MultiTOS.
  132.  
  133. If  at times something doesn't appear to be working,  then  I  suggest 
  134. that you first check the settings with the configuration program  (see 
  135. below).
  136.  
  137. Now, off we go ...
  138.  
  139.  
  140. 3.1 Flying Dials
  141. ----------------
  142.  
  143. Within  a GEM dialog there are selectable and non-selectable  objects. 
  144. If  you  left-click  on  a non-selectable  object  and  keep  the  key 
  145. depressed,  the mouse arrow changes into a flat hand and you can  drag 
  146. the dialog around by moving the mouse. Depending on how `Let 'em Fly!' 
  147. has  been configured (see below) one can move the dialog box  in  real 
  148. time,  or  only as a frame (like normal windows are moved).  By  first 
  149. pressing  and holding down one of the [SHIFT]-keys or the right  mouse 
  150. button,  you  can make the dialog box disappear to leave just a  ghost 
  151. outline,  i.e.  the dialog gets transparent and you can look `through' 
  152. it  should some important information be hidden behind it.  The  ghost 
  153. frame  can naturally also be moved.  On releasing the left button  the 
  154. dialog will reappear on the screen. One can also reverse the operation 
  155. of the right mouse button with the configuration program.
  156.  
  157. Note:  It may be that other programs that explicitly support `Let  'em 
  158. Fly!' are only able to `fly' by using a special object (the Selectricâ„¢ 
  159. file selector,  for instance,  supports `Let 'em Fly!' and in that one 
  160. can  move  dialog  boxes  via an `asses ear' at  the  top  right  hand 
  161. corner). But one can suppress the exclusitivity of the `flight object' 
  162. by  additionally pressing the right mouse button,  i.e.  one can  then 
  163. also use other objects for flying the dialog.
  164.  
  165. If  a  box can be moved normally but cannot be made  transparent  then 
  166. there is not enough memory available to save the complete dialog  box. 
  167. The first mode divides the flight path into a corresponding number  of 
  168. individual  steps  when there is a memory shortage and  then  executes 
  169. them, so offering more possibilities to complete the task.
  170.  
  171. If one clicks outside the dialog then normally this would only make  a 
  172. `pling'  (sound  the  bell) but with `Let 'em Fly!'  the  dialog  also 
  173. `flies'  to the mouse position.  This function is particularly  useful 
  174. with large screens. In addition, a double-click on the `flight object' 
  175. centres the dialog on the screen.
  176.  
  177. Furthermore  `Let 'em Fly!' remembers the last position of the  dialog 
  178. boxes within a program, which means that if one moves the dialogs they 
  179. will be displayed at their new position the next time they are called. 
  180. By  pressing [ALT]+[CTRL] when calling (!) the dialog the box will  be 
  181. correctly re-centred.  This function will also operate with  `foreign' 
  182. flight routines.
  183.  
  184. It  is also possible to make dialog boxes appear at the current  mouse 
  185. position.
  186.  
  187. With virtual scr